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Preface 


This document describes the Analytic Patch Configuration (APC) Gateway, release 1 .0. It is intended to 
serve as a “cookbook" reference for all users. New users are directed to read the introductory section, 
then study the sample sessions presented in appendix A. Readers not familiar with the APC format are 
referred to appendix B of this document, or to the CSC (Langley Operation) Internal Reference Document 
titled “Analytic Patch Configuration (APC) File Description.” 

This software was developed by Computer Sciences Corporation, Applied Technology Division, under 
contract to the National Aeronautics and Space Administration's Langley Research Center, during the 
Autumn of 1989. CSC supports this package only at Langley Research Center. 
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Introduction 


General Description and Purpose 

The Analytic Patch Configuration (APC) Gateway is a software tool for converting analytic geometry data 
from one format to another via the APC format. For example, the Gateway can be used to convert files 
among the four accepted APC formats, or to convert a Patran 2.x neutral file to an Integrated Aerodynamic 
Analysis System (IAAS) General Geometry (GG) file. 


Features 

The major features offered by the Gateway are: 

Dialogue Driven - Because the Gateway asks all the necessary questions, and accepts a variety of 
plain English answers, even new or occasional users can effectively transform their data files. 

Automatic Formatting - When it opens an incoming data file, the Gateway automatically 
determines its format. This feature is particularly handy when receiving unfamiliar data files from 
unknown or foreign sources. 

Consolidation - An attempt has been made to include most analytic geometry formats used at 
Langley into this software package. This allows Langley's researchers to use this single "geometry 
gateway" for their geometry transformations. 

Error Messages - All error messages are written in plain English, and every effort has been made to 
describe the problem as clearly as possible. A complete list of all error messages, including a further 
explanation and suggested remedies, is presented in appendix B. 

Portability - Perhaps the Gateway's most enduring feature is its ability to execute on a variety of 
operating systems. Developed under UNIX, it also executes under VMS and NOS. 


Limits 

The Gateway reads and writes entire geometry files, not file fragments. Consequently, there is an upper 
limit on the total number of raw data cells it can accommodate. The capacity of the Gateway is 1 ,000 
components and 10,000 surfaces. However, these capacities may change as the Gateway is installed on 
different hosts. Both limits are set once in a central part of the Gateway and are easily modified. If and 
when a data file exceeds either limit a clear error message is written. 


Associated Products 

Three companion packages, the Analvtic-to-Wireframe Geometry Translator , the Wireframe-to-Analvtic 
Geometry Translator, and the LaWGS Octopus. allow additional geometry data manipulations. All three 
packages are available and supported at NASA Langley Research Center. 
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Interactive Use 


Files 

The user is responsible for ensuring that all incoming geometry files are available to the Gateway. This 
normally requires that “read” permission be granted to the user, the default on most systems. 

The exception is NOS, where the file can only be made available ("local") by using the command 

GET, filename 

where filename is the name of the permanent file to be made local. In addition, the files created can only 
be retained (“saved”) by using the command 

S AV E filename 
or 

REPLACE filename 

where filename is the name of the tocal file to be made permanent. (Remember the NOS command SAVE 
makes a tocal file permanent only when a permanent file by that name doesnl already exist; the REPLACE 
command always makes the tocal file permanent, whether a permanent file by that name already exists or 
not.) 


Execution 

How the Gateway is executed depends upon the host computer system. However, most installations 
require only that 


apcgw 

be entered to begin execution. Again the exception is NOS, where the commands 

GET,APCGW/UN=NTFLIB 

APCGW 

are required. The following welcome banner then appears; 


A P C Gateway 


Release 1.0 November 1989 


The release number and date will change as new versions of the Gateway are installed. 
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Incoming Geometry File 

The first question is: 

What is the name of the incoming file ? 

A file name must be provided - the Gateway cannot assume a file name. The file name must be valid for the 
host operating system (e.g., most operating systems do not allow a file name to begin with a number). 

Also, the file must exist, and it must not be in use (or “locked") by another user or another process. Finally, 
the file cannot be empty. If any of these conditions are not met the Gateway writes an error message and 
repeats the question. (For more information regarding a specific error message, please refer to Appendix 
C - Warnings and Error Messages.) 

The Gateway may be stopped here by entering quit, qul, or q. 

After the file is opened, the Gateway attempts to match its contents to a recognized geometry file format. 
This process is invisible to the user. Once a match is made, the Gateway writes the message 


This file uses APC format 89f. 
in the case of an APC 89f file. Other formats generate a similar message. 


Outgoing Geometry File 

The next question is: 

What name should be given to the new file being created ? 

A file name must be provided - the Gateway cannot assume a file name. The file name must be valid for the 
host operating system. If the file already exists, the user must have “write" permission on it, and it cannot 
be in use (“locked”) by another user or another process. If the file does not already exist, it is created in 
the active directory. 

The Gateway may be stopped here by entering quit, qul, or q. 


Outgoing Geometry File Format 

The next question is: 


What format should be used for the new file ? 

The Gateway attempts to match the format name provided with an internal list of formats supported. For 
example, 89f is accepted as a request for an APC 89f file. The other formats have comparable aliases. 
For a complete list of the available formats, and their aliases, answer this question with help or ?. 

The Gateway may be stopped here by entering quit, qul, or q. 
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Recycle Dialogue 

The final question is: 

Do you wish to convert another file ? 

If another file is to be translated, enter yes or y. This starts the dialogue cycle again, beginning with the 
incoming geometry file question. Even if the cycle is restarted by mistake, the Gateway stops when any 
questions are answered with a quit, qul, or q. 

If no other file is to be translated, enter no, n, quit, qul, or q. 
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In Case of Problems 


General 

No software is above design and development errors. If you uncover an error, or notice some strange 
behavior, please follow the steps described below. One minute of your time may save hours or even days 
of effort. 


Langley Users - All Systems 

If possible, assemble the following information: 

1. Your host computer's manufacturer, model, operating system, and location. 

2. The incoming data file name. 

3. The desired outgoing data format. 

Then call Bradford Bingel (“Bing”) at Computer Sciences Corporation, (804) 865-1725. Every attempt will 
be made to correct the problem, when possible, within a few minutes . 


Non-Langley Users - All Systems 

Computer Sciences Corporation does not support the APC Gateway outside of NASA Langley. All 
questions and problems concerning this software should be directed to Dr. John E. Lamar, mail stop 361 , 
(804) 864-2851 . 


All comments are appreciated and welcomed !!! 
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Appendix A 
Sample Sessions 


Smj2l& Session 

% apcgw 


APC Gateway 
Release 1.0 November 1989 


What is the name of the incoming file ? 

> apc89f 

This file uses APC format 89f, 

What name should be given to the new file being created ? 

> q 

% 


This example illustrates how the Gateway's "auto-format" feature may be 
used to determine the format of an individual geometry file. 
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Sample Session #2 

% apcgw 


APC Gateway 
Release 1.0 November 1989 


What is the name of the incoming file ? 

> apc8 9f 

This file uses APC format 89f. 

What name should be given to the new file being created ? 

> patnf 

What format should be used for the new file ? 

> pat2 

Do you wish to convert another file ? 

> y 


What is the name of the incoming file ? 

> 14 

”14” is an improper file name. 

What is the name of the incoming file ? 

> patnf 

”patnf M is a Patran 2.x neutral file. 

What name should be given to the new file being created ? 

> fl06gg 

"fl06gg" is being rewritten. 

What format should be used for the new file ? 

> help 
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The available formats are: 


> gg 


> X 


Format 

APC format 89f 
APC format 89fd 
APC format 89u 
APC format 89ud 
Patran 2.x 
IAAS GG 

What format should be 


Aliases 

89f 
89fd 
89u 
8 9ud 

patran2 pat2 

gg 

d for the new file ? 


Do you wish to convert another file ? 


> n 


Please answer with a YES or a NO. 


% 


Normal session. 


This example illustrates a complete Gateway dialogue, including an 
assortment of error conditions and their corresponding messages. 
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Appendix B 
The APC File Format 


Analytic Bicubic Parametric Patches 

Imagine two independent parametric variables, Ci and C 2 , which vary over the interval [0,1], and three 
continuous functions, F x , F y , and F z , which use C-) and C 2 : 


x - F x (C^ , C 2 ) 
y * Fy (C 1 , C 2 ) 
z«F z (C 1 ,C 2 ) 


These three functions are combined to create an (x,y,z) location in three-dimensional space: 

(x.YiZ) = (F x ,Fy,F z ) = ( F x (C-j , C 2 ), Fy (C-j , C 2 ), F z (Ci , C 2 )) 

Since F x , F y , F z Ci and C 2 are all continuous over the interval [0,1], the set of points (F x ,F y ,F z ) define a 
continuous surface in three-dimensional space, a bicubic parametric patch 


Each of the bicubic parametric functions F x , F y 

f and F z 

has the form: 



^x,y,z “ 

+ 

a 1 c 1 


a 2 c t 2 

+ 

a 3 Ci 3 

a4C 2 

+ 

®5^lC 2 

+ 

3gCi 2 C 2 

+ 

a7C*|^C2 

aeC 2 2 

+ 

agCiC 2 2 

+ 

a 10 C 1 2c 2 2 

+ 

a 1fCi 3 C 2 2 

a 1 2 C 2 3 

+ 

a 13 C 1 C 2 3 

+ 

a u CfC 2 3 

+ 

a 1 5 Ci 3 C 2 3 


where the coefficients a 0 through ai 5 are independent for each function F x , F y , and F z . In other words, 

each surface is defined by 48 (3 sets of 16) coefficients. This patch description is often called the "alpha" 
or "algebraic” definition of a surface. 


Components 

A geometric configuration is usually made up of many patches, often grouped into components. For 
example, an aircraft configuration's wing may be defined as a separate component containing the set of 
patches which, collectively, describe the wing. Other portions of the configuration, such as the fuselage 
or vertical tail, may also be defined as separate components. 

The patches contained in each component are not necessarily mutually exclusive. That is, a patch which 
belongs to a component may also belong to other components. For example, a common technique is to 
break the configuration up into components, but retain all patches in the component “ALL". Another 
common technique is to have nested components. For example, the wing may be broken up into a root 
section, one or more mid-sections, and a tip section. Each of these components may be further divided 
into an upper surface, a lower surface, and a leading edge. Under this example, a single patch on the 
wing's leading edge would belong to at least three components. 
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The APC File 


The Analytic Patch Configuration (APC) file is sequential and unformatted . It contains three groups of 
records: header, component, and coefficient. 

Every APC file begins with exactly three 80-character header records: 

Analytic Patch Configuration File 
Format 89u 
descriptive title 


The first two records must contain the text strings shown. The third record may contain any descriptive 
text string, so long as it does not exceed 80 characters. The corresponding FORTRAN fragments are: 

Reading character*so textso, title 

READ (iounit) TEXT80 

IF (TEXT80 .NE . 'Analytic Patch Configuration File') — > error 
READ ( iounit) TEXT80 

IF (TEXTSO .NE. 'Format 89u') — > error 

READ ( iounit ) TITLE 

Writing character*80 textso, title 

TEXT80 = 'Analytic Patch Configuration File' 

WRITE ( iounit ) TEXT80 
TEXT80 = 'Format 89u' 

WRITE ( iounit ) TEXT80 
WRITE ( iounit ) TITLE 

The component records define the configuration's component structure. The records have the format: 


# of components 


component index 

component name 

number of patches 

patch id 

patch id 

patch id 


component index 

component name 

number of patches 

patch id 

patch id 

patch id 



component index 

component name 

number of patches 

patch id 

patch id 

patch id 

l_|> 
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Notice that if the first record contains a zero (indicating no components exist), the subsequent component 
definition records should not be processed. The corresponding FORTRAN fragments are: 


Reading character* 4 o 

INTEGER 

INTEGER 

INTEGER 


CNAME ( component__capacity ) 

C INDEX { component^capacity) 
START ( component_capacity ) , 
PLIST ( patch_listjcapacity ) 


STOP ( component_capacity ) 


READ (iounit) NCOMPS 
IF (NCOMPS. GT.O) THEN 

IF (NCOMPS. GT . component_capacity) — > error 
IBASE = 0 

DO ICOMP » 1, NCOMPS 

READ (iounit) CINDEX (ICOMP) , CNAME ( ICOMP) , NUMBER 
START (ICOMP) ~ IBASE + 1 
STOP (ICOMP) - IBASE + NUMBER 

IF (STOP (ICOMP) .GT . patch_list_capacity) — > error 
IF (NUMBER. GT.O) 

+ READ (iounit) (PLIST (K) , RESTART (ICOMP) , STOP (ICOMP) ) 

IBASE = IBASE + NUMBER 
END DO 
END IF 


Writing character* 4 o 

INTEGER 

INTEGER 

INTEGER 


CNAME ( component^capacity ) 
CINDEX (component^capacity) 
START (component__capacity) , 
PLIST ( patch_list_capacity ) 


STOP (co/nponent_capaci ty) 


WRITE (iounit) NCOMPS 
IF (NCOMPS .GT. 0) THEN 
DO ICOMP - 1, NCOMPS 

NUMBER = STOP (ICOMP) - START (ICOMP) + 1 

WRITE (iounit) CINDEX (ICOMP) , CNAME (ICOMP) , NUMBER 

IF (NUMBER. GT.O) 

+ WRITE ( iounit ) (PLIST (K) , K=START (ICOMP) , STOP ( ICOMP) ) 

END DO 
END IF 


The coefficient records define each patch in the configuration. The records have the format: 


# of patches 


patch index 

coefficient 

coefficient 

patch index 

coefficient 

coefficient 


patch index 


coefficient 


coefficient 


^ > 

>=> 
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The corresponding FORTRAN fragments are: 

Reading INTEGER P INDEX (pat ch_capa city) 

REAL COEF (48, patch_capacity) 

INTEGER N SURFS 

READ (iounit) NSURFS 
IF (NSURFS. GT.O) THEN 

IF (NSURFS . GT . patch_capacity) — > error 
DO IPATCH = 1, NSURFS 

READ ( iounit ) PINDEX (IPATCH) , (COEF (K, IPATCH) ,K=1, 48) 
END DO 
END IF 

Writing INTEGER PINDEX {patch_capacity) 

REAL COEF (48,patch_capacity) 

INTEGER NSURFS 

WRITE ( iounit ) NSURFS 
IF (NSURFS. GT.O) THEN 
DO IPATCH - 1, NSURFS 

WRITE (iounit) PINDEX ( IPATCH) , (COEF (K, IPATCH) , K=1 , 48 ) 
END DO 
END IF 


Eliminating Host Dependencies 

APC files were designed to be unformatted in order to minimize their relatively large storage size and 
significantly improved I/O response. Unfortunately, this same feature also prevents them from being 
transferred across communications networks to other host computers. 

APC files have a formatted counterpart. They contain the exact same information, but use FORTRAN list- 
directed READ'S and WRITE’S. The only difference is "89f" replaces "89u" in the second header record. 
Once an APC file is converted from unformatted to formatted, it can be transferred to a different host 
computer, then converted from formatted back into unformatted, with little or no loss in accuracy. This 
technique allows users to freely transfer APC files between different hosts. 

The APC file design also accommodates double precision files. The REAL coefficients become DOUBLE 
PRECISION and "89ud" replaces "89u" in the second header record. Its formatted equivalent follows the 
pattern described above, and M 89fd" replaces "89ud” in the second header record. 

Finally, APC applications software running under an operating system which doesn't support the ASCII 
character set (such as CDC/NOS) may write APC header records using all uppercase letters. So that APC 
files may be freely transferred between different host computers, att APC applications software should be 
able to read and accept APC files with all uppercase header records. 
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Appendix C 

Warnings and Error Messages 


The APC Gateway generates few error messages. Each was designed to be self-explanatory, but 
occasionally they may be misinterpreted. The purpose of this appendix is to clarify the situation creating 
the error, and, where appropriate, suggest techniques which may help to avoid similar problems in the 
future. 

All error messages are listed in alphabetical order. 


"filename" appears to be empty. 

The file exists, yet contains no information. On most operating systems this is possible when 
some previous I/O operation created a new file without transferring any data. 


"filename" does not exist. 

The requested file does not exist, or the file exists but "read" permission is denied. Note that file 
names are case sensitive on UNIX installations (i.e., file “GEOM1" is unique from file “geoml"). 


"filename" Is already In use. 

The requested file exists, but another user (or another process) has it "locked," making it 
inaccessible to the Gateway. 


"filename" Is an Improper file name. 

The file name provided is not valid on the host operating system. The most common problems are 
having a number as the first character, or using some special character (!@#$%) anywhere in the 
name. 


"filename" is a reserved file name. 

The file name provided is reserved for use only by the host operating system. For example, file 
stdout is reserved under UNIX, and SYS$INPUT is reserved under VMS. 


" filename " Is being rewritten. 

The outgoing file specified already exists. Its original contents will be lost as the Gateway writes 
the new information in its place. 
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Capacity limit - Component lists are too long. 

Only number total elements can be accommodated. 

The Gateway cannot dynamically allocate central memory. Consequently, there is a limit placed on 
the extent of the components' element lists. If the file exceeds this limit, this message appears. 
When possible, a quick solution is to break up the file into two or more smaller files. However, if 
this message begins to appear regularly, please follow the steps listed in the section “In Case of 
Problems . . and ask for the Gateway’s element list capacity to be increased. 


Capacity limit - Too many components. 

Only number components can be accommodated. 

The Gateway cannot dynamically allocate central memory. Consequently, there is a limit placed on 
the number of components it can handle. If the file exceeds this limit, this message appears. 
When possible, a quick solution is to break up the file into two or more smaller files. However, if 
this message begins to appear regularly, please follow the steps listed in the section “In Case of 
Problems . . ." and ask for the Gateway's component capacity to be increased. 


Capacity limit - Too many surfaces. 

Only number surfaces can be accommodated. 

The Gateway cannot dynamically allocate central memory. Consequently, there is a limit placed on 
the number of surfaces it can handle. If the file exceeds this limit, this message appears. When 
possible, a quick solution is to break up the file into two or more smaller files. However, if this 
message begins to appear regularly, please follow the steps listed in the section “In Case of 
Problems . . .” and ask for the Gateway’s surface capacity to be increased. 


Format 89u Is assumed. 

If you only press the Return key in response to the question What format should be used for the 
new file?, APC format 89u (the default format) is assumed. 


Internal Fatal Error - Ghost File. 

Please contact the APC Gateway support team. 

Internal fatal errors appear when logic errors occur within the software. Please accept the 
developer's apologies for any consequential inconvenience, and follow the steps listed in the 
section “In Case of Problems ..." to report this message. 


Internal Fatal Error - Improper I/O Unit Passed. 

Please contact the APC Gateway support team. 

Internal fatal errors appear when logic errors occur within the software. Please accept the 
developer's apologies for any consequential inconvenience, and follow the steps listed in the 
section “In Case of Problems . . ." to report this message. 
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Internal Fatal Error • RGG #1. 

Please contact the APC Gateway support team. 

Internal fatal errors appear when logic errors occur within the software. Please accept the 
developer's apologies for any consequential inconvenience, and follow the steps listed in the 
section "In Case of Problems ...” to report this message. 


Internal Fatal Error * RGG #2. 

Please contact the APC Gateway support team. 

Internal fatal errors appear when logic errors occur within the software. Please accept the 
developer’s apologies for any consequential inconvenience, and follow the steps listed in the 
section “In Case of Problems . . to report this message. 


Internal Fatal Error - Unknown Error Code. 

Please contact the APC Gateway support team. 

Internal fatal errors appear when logic errors occur within the software. Please accept the 
developer's apologies for any consequential inconvenience, and follow the steps listed in the 
section “In Case of Problems . . "to report this message. 


Please answer with a YES or a NO. 

The preceding question asked for a simple yes/no response. The Gateway accepts any of the 
following: yes, y, no, or n. In addition, the Gateway stops when any of the following responses 
are entered: quit, qul, q. Any other response appears as an unclear answer. 


Sorry, but couldn't understand your answer. 

Please try again. 

For some unknown reason, the Gateway did not receive your response. This usually occurs after 
an unsuccessful attempt to alter a response by using a series of control characters. 


This doesn't look like an APC file. 

This incoming file satisfied the APC quick-screen tests but, upon closer inspection, does not 
meet all of the APC format requirements. This often occurs with formatted versions (89f and 89fd) 
after a slight variation was introduced during an editing session. 


This doesn't look like an IAAS GG file. 

This incoming file satisfied the IAAS GG quick-screen tests but, upon closer inspection, does not 
meet all of the GG format requirements. This often occurs when the unformatted GG file is 
improperly retrieved from a remote host. 
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This doesn't look like a Patran 2.x neutral file. 

This incoming file satisfied the Patran neutral file quick-screen tests but, upon closer inspection, 
does not meet all of Patran's format requirements. This often occurs after a slight variation was 
introduced during an editing session. 

This file appears to be empty. 

The file exists, yet contains no information. On most operating systems this is possible when 
some previous I/O operation created a new file without transferring any data. 


This file's format Isn't recognized. 

The incoming geometry file is not in a recognized format. Those formats which are recognized by 
the Gateway, along with their abbreviations/aliases, are then listed below the error message. If you 
would like to see a new format added to the Gateway's vocabulary, or believe that additional aliases 
are needed for an existing format, please follow the steps listed in the section “In Case of 
Problems . . and ask for the enhancement. 


Unable to open this file. Please try another. 

For any of a number of reasons, the requested file cannot be accessed. This situation should be 
somewhat rare, as the more common causes (e.g., the file doesn't exist, or it’s locked by another 
user) are successfully diagnosed to create pinpoint explanations. The underlying cause is usually 
system-dependent, putting the Gateway in the unenviable position of writing this general error 
message. The only recommended remedy is to stop the Gateway, reestablish all file connections, 
and reexecute. 


Unclear or unavailable format. 

The incoming geometry file is not in a recognized format. Those formats which are recognized by 
the Gateway, along with their abbreviations/aliases, are then listed below the error message. If you 
would like to see a new geometry format added to the Gateway's vocabulary, or believe that 
additional aliases are needed for an existing format, please follow the steps listed in the section “In 
Case of Problems . . and ask for the enhancement. 


You must enter a file name . . . 

The Gateway cannot assume the incoming or outgoing file’s name. After this message appears 
the question asking for the file name is repeated. 
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